<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkAboutDialog</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="WindowWidgets.html" title="窗口">
<link rel="prev" href="gtk3-GtkWindowGroup.html" title="GtkWindowGroup">
<link rel="next" href="gtk3-GtkAssistant.html" title="GtkAssistant">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkWindowGroup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="WindowWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkAssistant.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkAboutDialog.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkAboutDialog.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkAboutDialog"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkAboutDialog.top_of_page"></a>GtkAboutDialog</span></h2>
<p>GtkAboutDialog — Display information about an application</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkAboutDialog.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog">GtkAboutDialog</a>;
enum                <a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense">GtkLicense</a>;
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-new" title="gtk_about_dialog_new ()">gtk_about_dialog_new</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-program-name" title="gtk_about_dialog_get_program_name ()">gtk_about_dialog_get_program_name</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-program-name" title="gtk_about_dialog_set_program_name ()">gtk_about_dialog_set_program_name</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-version" title="gtk_about_dialog_get_version ()">gtk_about_dialog_get_version</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-version" title="gtk_about_dialog_set_version ()">gtk_about_dialog_set_version</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *version</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-copyright" title="gtk_about_dialog_get_copyright ()">gtk_about_dialog_get_copyright</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-copyright" title="gtk_about_dialog_set_copyright ()">gtk_about_dialog_set_copyright</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *copyright</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-comments" title="gtk_about_dialog_get_comments ()">gtk_about_dialog_get_comments</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-comments" title="gtk_about_dialog_set_comments ()">gtk_about_dialog_set_comments</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *comments</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-license" title="gtk_about_dialog_get_license ()">gtk_about_dialog_get_license</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-license" title="gtk_about_dialog_set_license ()">gtk_about_dialog_set_license</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *license</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-wrap-license" title="gtk_about_dialog_get_wrap_license ()">gtk_about_dialog_get_wrap_license</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-wrap-license" title="gtk_about_dialog_set_wrap_license ()">gtk_about_dialog_set_wrap_license</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap_license</code></em>);
<a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense"><span class="returnvalue">GtkLicense</span></a>          <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-license-type" title="gtk_about_dialog_get_license_type ()">gtk_about_dialog_get_license_type</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-license-type" title="gtk_about_dialog_set_license_type ()">gtk_about_dialog_set_license_type</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense"><span class="type">GtkLicense</span></a> license_type</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-website" title="gtk_about_dialog_get_website ()">gtk_about_dialog_get_website</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-website" title="gtk_about_dialog_set_website ()">gtk_about_dialog_set_website</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-website-label" title="gtk_about_dialog_get_website_label ()">gtk_about_dialog_get_website_label</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-website-label" title="gtk_about_dialog_set_website_label ()">gtk_about_dialog_set_website_label</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website_label</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-authors" title="gtk_about_dialog_get_authors ()">gtk_about_dialog_get_authors</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-authors" title="gtk_about_dialog_set_authors ()">gtk_about_dialog_set_authors</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **authors</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-artists" title="gtk_about_dialog_get_artists ()">gtk_about_dialog_get_artists</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-artists" title="gtk_about_dialog_set_artists ()">gtk_about_dialog_set_artists</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **artists</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-documenters" title="gtk_about_dialog_get_documenters ()">gtk_about_dialog_get_documenters</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-documenters" title="gtk_about_dialog_set_documenters ()">gtk_about_dialog_set_documenters</a>    (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **documenters</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-translator-credits" title="gtk_about_dialog_get_translator_credits ()">gtk_about_dialog_get_translator_credits</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-translator-credits" title="gtk_about_dialog_set_translator_credits ()">gtk_about_dialog_set_translator_credits</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *translator_credits</code></em>);
<a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-logo" title="gtk_about_dialog_get_logo ()">gtk_about_dialog_get_logo</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-logo" title="gtk_about_dialog_set_logo ()">gtk_about_dialog_set_logo</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *logo</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-get-logo-icon-name" title="gtk_about_dialog_get_logo_icon_name ()">gtk_about_dialog_get_logo_icon_name</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-logo-icon-name" title="gtk_about_dialog_set_logo_icon_name ()">gtk_about_dialog_set_logo_icon_name</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkAboutDialog.html#gtk-show-about-dialog" title="gtk_show_about_dialog ()">gtk_show_about_dialog</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkAboutDialog.description"></a><h2>Description</h2>
<p>
The GtkAboutDialog offers a simple way to display information about
a program like its logo, name, copyright, website and license. It is
also possible to give credits to the authors, documenters, translators
and artists who have worked on the program. An about dialog is typically
opened when the user selects the <code class="literal">About</code> option from
the <code class="literal">Help</code> menu. All parts of the dialog are optional.
</p>
<p>
About dialog often contain links and email addresses. GtkAboutDialog
displays these as clickable links. By default, it calls <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri" title="gtk_show_uri ()"><code class="function">gtk_show_uri()</code></a>
when a user clicks one. The behaviour can be overridden with the
<span class="type">"activate-link"</span> signal.
</p>
<p>
To make constructing a GtkAboutDialog as convenient as possible, you can
use the function <a class="link" href="gtk3-GtkAboutDialog.html#gtk-show-about-dialog" title="gtk_show_about_dialog ()"><code class="function">gtk_show_about_dialog()</code></a> which constructs and shows a dialog
and keeps it around so that it can be shown again.
</p>
<p>
Note that GTK+ sets a default title of <code class="literal">_("About %s")</code>
on the dialog window (where %s is replaced by the name of the
application, but in order to ensure proper translation of the title,
applications should set the title property explicitly when constructing
a GtkAboutDialog, as shown in the following example:
</p>
<div class="informalexample"><pre class="programlisting">
gtk_show_about_dialog (NULL,
                       "program-name", "ExampleCode",
                       "logo", example_logo,
                       "title" _("About ExampleCode"),
                       NULL);
</pre></div>
<p>
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkAboutDialog.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkAboutDialog"></a><h3>struct GtkAboutDialog</h3>
<pre class="programlisting">struct GtkAboutDialog {
  GtkDialog parent_instance;
};
</pre>
<p>
The <span class="structname">GtkAboutDialog</span> struct contains
only private fields and should not be directly accessed.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkLicense"></a><h3>enum GtkLicense</h3>
<pre class="programlisting">typedef enum {
  GTK_LICENSE_UNKNOWN,
  GTK_LICENSE_CUSTOM,

  GTK_LICENSE_GPL_2_0,
  GTK_LICENSE_GPL_3_0,

  GTK_LICENSE_LGPL_2_1,
  GTK_LICENSE_LGPL_3_0,

  GTK_LICENSE_BSD,
  GTK_LICENSE_MIT_X11,

  GTK_LICENSE_ARTISTIC
} GtkLicense;
</pre>
<p>
The type of license for an application.
</p>
<p>
This enumeration can be expanded at later date.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="GTK-LICENSE-UNKNOWN:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_UNKNOWN</code></span></p></td>
<td>No license specified
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-CUSTOM:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_CUSTOM</code></span></p></td>
<td>A license text is going to be specified by the
  developer
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-GPL-2-0:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_GPL_2_0</code></span></p></td>
<td>The GNU General Public License, version 2.0
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-GPL-3-0:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_GPL_3_0</code></span></p></td>
<td>The GNU General Public License, version 3.0
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-LGPL-2-1:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_LGPL_2_1</code></span></p></td>
<td>The GNU Lesser General Public License, version 2.1
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-LGPL-3-0:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_LGPL_3_0</code></span></p></td>
<td>The GNU Lesser General Public License, version 3.0
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-BSD:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_BSD</code></span></p></td>
<td>The BSD standard license
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-MIT-X11:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_MIT_X11</code></span></p></td>
<td>The MIT/X11 standard license
</td>
</tr>
<tr>
<td><p><a name="GTK-LICENSE-ARTISTIC:CAPS"></a><span class="term"><code class="literal">GTK_LICENSE_ARTISTIC</code></span></p></td>
<td>The Artistic License, version 2.0
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-new"></a><h3>gtk_about_dialog_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_about_dialog_new                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a newly created <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-program-name"></a><h3>gtk_about_dialog_get_program_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_program_name   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the program name displayed in the about dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The program name. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-program-name"></a><h3>gtk_about_dialog_set_program_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_program_name   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<p>
Sets the name to display in the about dialog.
If this is not set, it defaults to <a href="../glib/glib-Miscellaneous-Utility-Functions.html#g-get-application-name"><code class="function">g_get_application_name()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td>the program name</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-version"></a><h3>gtk_about_dialog_get_version ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_version        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the version string.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The version string. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-version"></a><h3>gtk_about_dialog_set_version ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_version        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *version</code></em>);</pre>
<p>
Sets the version string to display in the about dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
<td>版本字符串. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-copyright"></a><h3>gtk_about_dialog_get_copyright ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_copyright      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
返回版权字符串。
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The copyright string. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-copyright"></a><h3>gtk_about_dialog_set_copyright ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_copyright      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *copyright</code></em>);</pre>
<p>
Sets the copyright string to display in the about dialog.
This should be a short string of one or two lines.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>copyright</code></em> :</span></p></td>
<td>(allow-none) 返回版权字符串。</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-comments"></a><h3>gtk_about_dialog_get_comments ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_comments       (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the comments string.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The comments. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-comments"></a><h3>gtk_about_dialog_set_comments ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_comments       (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *comments</code></em>);</pre>
<p>
Sets the comments string to display in the about dialog.
This should be a short string of one or two lines.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>comments</code></em> :</span></p></td>
<td>a comments string. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-license"></a><h3>gtk_about_dialog_get_license ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_license        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the license information.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The license information. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-license"></a><h3>gtk_about_dialog_set_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_license        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *license</code></em>);</pre>
<p>
Sets the license information to be displayed in the secondary
license dialog. If <em class="parameter"><code>license</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the license button is
hidden.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>license</code></em> :</span></p></td>
<td>the license information or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-wrap-license"></a><h3>gtk_about_dialog_get_wrap_license ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_about_dialog_get_wrap_license   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns whether the license text in <em class="parameter"><code>about</code></em> is
automatically wrapped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the license text is wrapped</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-wrap-license"></a><h3>gtk_about_dialog_set_wrap_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_wrap_license   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap_license</code></em>);</pre>
<p>
Sets whether the license text in <em class="parameter"><code>about</code></em> is
automatically wrapped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>wrap_license</code></em> :</span></p></td>
<td>whether to wrap the license</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-license-type"></a><h3>gtk_about_dialog_get_license_type ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense"><span class="returnvalue">GtkLicense</span></a>          gtk_about_dialog_get_license_type   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Retrieves the license set using <a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-license-type" title="gtk_about_dialog_set_license_type ()"><code class="function">gtk_about_dialog_set_license_type()</code></a>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense"><span class="type">GtkLicense</span></a> value</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-license-type"></a><h3>gtk_about_dialog_set_license_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_license_type   (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkLicense" title="enum GtkLicense"><span class="type">GtkLicense</span></a> license_type</code></em>);</pre>
<p>
Sets the license of the application showing the <em class="parameter"><code>about</code></em> dialog from a
list of known licenses.
</p>
<p>
This function overrides the license set using
<a class="link" href="gtk3-GtkAboutDialog.html#gtk-about-dialog-set-license" title="gtk_about_dialog_set_license ()"><code class="function">gtk_about_dialog_set_license()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>license_type</code></em> :</span></p></td>
<td>the type of license</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-website"></a><h3>gtk_about_dialog_get_website ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_website        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the website URL.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The website URL. The string is owned by the about
dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-website"></a><h3>gtk_about_dialog_set_website ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_website        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website</code></em>);</pre>
<p>
Sets the URL to use for the website link.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>website</code></em> :</span></p></td>
<td>a URL string starting with "http://". <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-website-label"></a><h3>gtk_about_dialog_get_website_label ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_website_label  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the label used for the website link.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The label used for the website link. The string is
owned by the about dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-website-label"></a><h3>gtk_about_dialog_set_website_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_website_label  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website_label</code></em>);</pre>
<p>
Sets the label to be used for the website link.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>website_label</code></em> :</span></p></td>
<td>the label used for the website link</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-authors"></a><h3>gtk_about_dialog_get_authors ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * gtk_about_dialog_get_authors      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the string which are displayed in the authors tab
of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the authors. The array is
owned by the about dialog and must not be modified. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-authors"></a><h3>gtk_about_dialog_set_authors ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_authors        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **authors</code></em>);</pre>
<p>
Sets the strings which are displayed in the authors tab
of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>authors</code></em> :</span></p></td>
<td>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-artists"></a><h3>gtk_about_dialog_get_artists ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * gtk_about_dialog_get_artists      (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the string which are displayed in the artists tab
of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the artists. The array is
owned by the about dialog and must not be modified. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-artists"></a><h3>gtk_about_dialog_set_artists ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_artists        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **artists</code></em>);</pre>
<p>
Sets the strings which are displayed in the artists tab
of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>artists</code></em> :</span></p></td>
<td>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-documenters"></a><h3>gtk_about_dialog_get_documenters ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * gtk_about_dialog_get_documenters  (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the string which are displayed in the documenters
tab of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the documenters. The
array is owned by the about dialog and must not be modified. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-documenters"></a><h3>gtk_about_dialog_set_documenters ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_documenters    (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **documenters</code></em>);</pre>
<p>
Sets the strings which are displayed in the documenters tab
of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>documenters</code></em> :</span></p></td>
<td>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-translator-credits"></a><h3>gtk_about_dialog_get_translator_credits ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_translator_credits
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the translator credits string which is displayed
in the translators tab of the secondary credits dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The translator credits string. The string is
owned by the about dialog and must not be modified.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-translator-credits"></a><h3>gtk_about_dialog_set_translator_credits ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_translator_credits
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *translator_credits</code></em>);</pre>
<p>
Sets the translator credits string which is displayed in
the translators tab of the secondary credits dialog.
</p>
<p>
The intended use for this string is to display the translator
of the language which is currently used in the user interface.
Using <code class="function">gettext()</code>, a simple way to achieve that is to mark the
string for translation:
</p>
<div class="informalexample"><pre class="programlisting">
 gtk_about_dialog_set_translator_credits (about, _("translator-credits"));
</pre></div>
<p>
It is a good idea to use the customary msgid "translator-credits" for this
purpose, since translators will already know the purpose of that msgid, and
since <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> will detect if "translator-credits" is untranslated
and hide the tab.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>translator_credits</code></em> :</span></p></td>
<td>the translator credits. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-logo"></a><h3>gtk_about_dialog_get_logo ()</h3>
<pre class="programlisting"><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_about_dialog_get_logo           (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the pixbuf displayed as logo in the about dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the pixbuf displayed as logo. The
pixbuf is owned by the about dialog. If you want to keep a
reference to it, you have to call <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on it. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-logo"></a><h3>gtk_about_dialog_set_logo ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_logo           (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *logo</code></em>);</pre>
<p>
Sets the pixbuf to be displayed as logo in the about dialog.
If it is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default window icon set with
<a class="link" href="gtk3-GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()"><code class="function">gtk_window_set_default_icon()</code></a> will be used.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>logo</code></em> :</span></p></td>
<td>a <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-logo-icon-name"></a><h3>gtk_about_dialog_get_logo_icon_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_about_dialog_get_logo_icon_name (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>
Returns the icon name displayed as logo in the about dialog.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the icon name displayed as logo. The string is
owned by the dialog. If you want to keep a reference
to it, you have to call <a href="../glib/glib-String-Utility-Functions.html#g-strdup"><code class="function">g_strdup()</code></a> on it.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-set-logo-icon-name"></a><h3>gtk_about_dialog_set_logo_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_about_dialog_set_logo_icon_name (<em class="parameter"><code><a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
<p>
Sets the pixbuf to be displayed as logo in the about dialog.
If it is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default window icon set with
<a class="link" href="gtk3-GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()"><code class="function">gtk_window_set_default_icon()</code></a> will be used.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>about</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkAboutDialog.html#GtkAboutDialog" title="struct GtkAboutDialog"><span class="type">GtkAboutDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
<td>an icon name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-show-about-dialog"></a><h3>gtk_show_about_dialog ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_show_about_dialog               (<em class="parameter"><code><a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
This is a convenience function for showing an application's about box.
The constructed dialog is associated with the parent window and
reused for future invocations of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
<td>transient parent, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for none. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
<td>the name of the first property</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
</div>
<div class="refsect1">
<a name="gtk3-GtkAboutDialog.see-also"></a><h2>See Also</h2>
<a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-ABOUT:CAPS" title="GTK_STOCK_ABOUT"><span class="type">GTK_STOCK_ABOUT</span></a>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>